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Return Value 


Function Name 


Description 


bool 


getNextSession 


Returns false when there is no more session; 
true otherwise 


string 


getFileName 


Returns file name for the EventData 


map<string, string> 


getSessionlnformation 


Returns the map. Keys are UserlD, 
ApplicationlD, CumulativeSessionNumber, 
StartTime, and Duration. 


map<string, 
vector<string» 


getSessionEventData 


Returns the map. Keys are EventName and 
EventTiming. The values of EventTiming 
vector are in the unit of 10th of a second 
converted from unsigned integer to string. 



Figure 12B 
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Return Value 


Function Name 


Description 


bool 


getNextLine 


Returns one line of string data as an out 
parameter string. The function returns true if 
there is a line; false if no more line exists with 
empty string. 


string 


getFileNameWithSuffix 


Returns file name for the data with suffix if 
applicable 



Figure 12C 



Page 57 of 78 



Application S/W 
Init 



Application S/W 
CommandX 
Handler 



1 : setAppiicatkmlDTMyProg") 



2: startMonitoringO 



Application S/W 
Closing 



3: record EventfCommand (") 



setectFofmatProtocol 



Monitoring 
System 



1 



5: stopMonitoringO 



r 



I 



6: send monitored information 

r>- 



T 



Figure 13 



Page 58 of 78 



Target 
Application 



1: i :opMonltortng 



CProcessorBuilderwiil cache me 
CAbsProtocolProcessors In an array. 





5 



CPrgcgS5on3ujider 



CMonttorSegApp 



2: stopMon) 



EventLogger 




ProtocolProcessor 



For a given format steps 8 and 9 are repeated D| 
r or each protocol in the protocol vector. Steps 5 
rough 9 are repeated for each format 



Format And Protocol 
information Base S^sU^> 



5: getFormatAndProtoeofVector 



int 

llst<int> 
YES 

9: processFormattedData 



CAbsFormattedEventData 



Data Format 
Processor 



Protocol Processor 



Figure 14 



Page 59 of 78 



" I 



Format 2 



Map 



key 



value 



Format 1 



pointer to 
function 



Data Formatter 
Builder 
Function 



Code 
in 

Memory 



i 



mDataFormatProcessorMap 
(in Figure 18 A) 



Figure 15 



Page 60 of 78 



void CMonitorManager: :stopMonitoring() 

TRACE ("CMonitorManager: : stopMonitoring \n") ; 



// 1. calls the function stopMonitoring () of 

// COsageLogger . 

m_rJsageLogger.stopMonltoringO ; 

// 2. calls the function getEventData ( ) of 

// COsageLogger . This function returns the usage 

// information, CAbs Event Data, to CMonitorManager. 

CAbsEventData * loc_pAbs Event Data ■ m_OsageLogger. getEventData ( > ; 

// 3. calls the function ge t Forma tAnd Protocol Vector () 

// of CFormatProtocol^InformationBase. This function 

// returns the following to CMonitorManager: an int for 

// the data format, a liat<int> for the communication 

// protocols, and a bool to indicate if the return 

// values (format and protocol) are valid. 



int loc_nFormat; 

list<int> loc_Protocol vector ; 

CProcesaor Builder loc_ProcessorBuilder; 

while (m_FormatProtocol_InformationBase. get Forma tAndProtocol Vector { 
loc_nFormat, 1 oc_Protocol Vector) ) i 

// 4. calls the function createDataFormatProcesaor ( ) 
// of CProcessorBuilder. CMonitorManager passes an 

// int for the data format into this function. This 

// function returns the data format processor, 

// CAbsDataFormatter, to CMonitorManager. 



CAbsDataFormatter * loc_pAbsDataFormatter - 

loc_ProcessorBui Ider.createDat a Format Processor (loc_nFormat ) 

// 5. calls the function forma tEvent Data ( ) of 
// CAbsDataFormatter. CMonitorManager passes the 

// usage information, CAbsEventData, into this 

// function. This function returns the formatted 

// usage information, CAbs Format tedEvent Data, to 

// CMonitorManager. 



CAbs Format tedEvent Data * locjpAbs Format tedEvent Data - 

loc _j>AbsDataFormatter->forma tEvent Data (loc_pAbsEventDat a) ,* 

// 6. calls the function createProtocolProcessor ( ) of 

// CProcessorBuilder. CMoni torManager passes an int 

// for the communication protocol into this function. 

// The int is the first int from the protocol vector, 

// list<int>. This function returns the protocol 

// processor, CAbsProtocol Processor, to CMonitorManager. 

for (list<int>: : iterator loc_ProtocolVectorlterator - 

loc_ProtocolVector. begin () ; loc_ProtocolVect or Iterator HE 
loc_ProtocolVector.end() ; loc_ProtocolVectorI terator ++)( 



Figure 16A 
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* 



CAbsProtocol Processor • loc_jiAbsProtocol Processor - 
loc_ProcessorBuilder . createProtocolProceooor ( 
* loc Protocol Vector Iterator ) ; 



// 7. calls the function process FormattedData ( ) of 
// CAbsProtocol Processor. CMonitorKanager passes the 

// formatted usage information, CAbsFormattedBventData, 

// into this function. This function returns a bool to 

// CMonitorManager to indicate if the usage information 

// was communicated using the protocol. 



loc_pAbs Protocol Processor- >process Forma ttedDat a ( 
loc_pAbs Forma ttedEvent Data) ; 



I 

// S. steps 6 and 7 are repeated for each protocol, 
// int, in the protocol vector, list<int>. 

) 

// 9. steps 3 through 8 are repeated for each format 
// until the function ge t Forma tAndProtocol Vector ( > 

// returns NO to CMonitorManager . 

) 
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3.3 CProccsscrBuildcr Class Spcctficatjoo 



3.3.1 Function List 
public: 

CProccssorBuilderO; 

-CProcessorBuUderO; 

CAbsDataFormatter* aeateOat&FonnatPFOCcssoi(int in_nFormat); 
CAbsProtocolProcessor* crealeProtocol Processorftnt in_nProtocol), 

private: 

void tnitDataFonnalPiDcessorMapO; 
void tnitProtooolPiDccssorMapO; 

Include the following functions to create the different data format processors and protocol processors. 
CAbsDataFormatter* creatcCc^nrnaDstaFonnattcrO; 
CAbsDatHFormatteT* createXMLDataFonnatterO; 
CAbsProtocoIProccssor* crcateSmtprVotocolPiocessorO; 
CAtisProtocolProcessor* createFtpProtocolProccssorO; 
If new data formats or new protocols are added, then new functions to create them must be added. 

Include the following typedef declarations for the functions that create the data format processors and protocol processors, 
typedef CAbsDataFormatter* ( * DataFormatProcessorB uildcr) 0; 
typedef CAbsProtocolPiocessoi » (*ProtocolProce$sorBuildcr) 0; 



3.3.2 Class Attributes 



Type 


Attribute Name 


Description 


CAbsDataFormatter* 


mjiDaiaFonrurOer 


This attribute member points to the data format processor object It is 
initialize to 0 in the constructor and the data format processor object is 
created by the function oratcDalaFonnatProccssorO . This function 
may be called multiple times so that it must delete the previous data 
format processor object pointed to by this attribute member before 
creating a new one. The destructor wilt delete the last data format 
processor object pointed to by this attribute member. 


map<int, 
DalaFormatFTOcessorBuilder> 


m_ProtocolPTocessorMap 


This attribute member is a map of pointers to functions that create the 
data format processor. The key to this map is an hit for the data format 

type. The value is a pointer to a function that creates the data format 
processor corresponding to the key. The pointers to the functions in the 
map arc initialized in the function initDataFormatProcessorMapO- 


map<int, 
pair<CAbsProtocoI Processor* , 
ProtocolFrocessorBuilder> > 


m_ProtocolPTOcessorMap 


rhis attribute member is a map of pointers to protocol processor object; 
and pointers to functions that create them. The key to this map is an inl 

for the protocol processor type. The value is a pair consisting of a 
pointer to the protocol processor object and a pointer to a function mat 

creates the protocol processor object All the pointers to the protocol 
processor object are initialized to 0 and its corresponding functions are 

mtializcd by the function initPTotocolProcessorMapO. The protocol 
processor objects are created by the function crcateProtocolProccssorO. 
The destructor will delete all the protocol processor objects pointed to 
by the map. 



Figure 18A 
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3.3.3 Function Definitions 

////////////////////////////////////////////////////////////////////////// 

// Function: CProcessorBuilder 

// Description: Constructor 

// Preconditions: None. 

// Postconditions: None. 

// Algorithm: 1. calls the private function 

// initDataFomatProcessorMapt) . 

// 2. calls the private function 

// initProtoco!ProcessorHap( ) . 

/////////////y //////////////////////////////////////////////////////////// 

////////////////////////////////////////////////////////////////////////// 

// Function: -CProcessorBuilder 

// Description: Destructor 

// Preconditions: None. 

// Postconditions: None. 

// Algorithm: 1. delete the object pointed to by m_j>DataFo matter . 

// 2. iterate through the map, m_ProtocolProcessorHap. 

// For each entry in the map, get the protocol 

// processor object pointed to by the pair and delete 

// the object. 

////////////////////////////////////////////////////////////////////////// 

////////////////////////////////////////////////////////////////////////// 

// Function: createDataFormatProcessor 

// Description: This function creates a data format processor 

// object. The data format processor object created 

// corresponds to the data format type in_nFormat. 

// Preconditions: The data format type must be valid. 

// Postconditions: The pointer to the data format processor object, 

// m_j>DataFormatter, cannot be 0. 

// Algorithm: 1. if m_pDataFormatter currently points to a data 

// format processor object, then delete the object. 

// 2. creates a new data format processor object by 

// calling the function in the map, 

// m_DataFormatProcessorMap, that corresponds to the 

// data format type, in_nFormat, and assign it to 

// m__pDataFormatter. 

// 3. returns m__pDataFonnatter. 

////////////////////////////////////////////////////////////////////////// 

////////////////////////////////////////////////////////////////////////// 

// Function: createProtocolProcessor 

// Description: This function creates a protocol processor object. 

// The protocol processor object created corresponds 

// to the protocol type in_nProtocol . 

// Preconditions: The protocol type must be valid. 

// Postconditions: The pointer to the created protocol processor object 

// cannot be 0. 

// Algorithm: 1. for the protocol type, in_nProtocol, get the 

// pair from the map that contains the pointer to 

// protocol processor object and its corresponding 

// pointer to the function that creates it, 

// 2. if the pointer to the protocol processor object 

// is 0, then use its corresponding function to create 

// it and assign it to the pointer in the map. Return 

// the pointer to the protocol processor object. 

// 3. if the pointer points to a protocol processor 

// object, then return this pointer. 



////////////////////////////////////////////////////////////////////////// 

Figurel8B 
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7//////////////////////////////////////////////////////////////////////// 
7 Private 

7 Function: initDataFormatProcessorMap 

7 Description: This function initializes all the function pointers 

/ in the map m_DataFormatProcessorMap . If new data 

7 formats are added, then this function must be 

7 modified. 

7 Preconditions: None. 

7 Postconditions: Hone. 

7 Algorithm: 1. add entries to the map, m_DataFormatProces3orMap, 

7 for each data format type. The key will be the 

7 data format type and the value will be the pointer 

7 to the corresponding function that creates the 

7 data format processor. 

7 2. for data format type 1, the function pointer 

7 points to createCommaDataFormatter {) . 

7 3. for data format type 2, the function pointer 

7 points to createXMLDat a Formatter ( ) . 

////////////// f ////////////////////////////////////////////////////// ft // 

///////////////////////////////////////////////////////////////////////// 
7 Private 

7 Function: initProtocolProcessorNap 

7 Description: This function initializes all the pairs of pointers 

7 in the map m_ProtocolProcessorKap. If new protocols 

7 are added, then this function must be modified. 

7 Preconditions: None. 

7 Postconditions: None. 

7 Algorithm: 1. add entries to the map, m_ProtocolProcessorMap, 

7 for each protocol type. The key will be the 

7 protocol type and the value will be a pointer to 

7 the protocol processor object and a pointer 

7 to the corresponding function that creates the 

7 protocol processor. All pointers to the protocol 

7 processor objects will be set to 0. 

7 2. for protocol type 1, the function pointer 

7 points to createSmtpProtocol Processor () . 

7 3. for protocol type 2, the function pointer 

7 points to createFtpProtocolProcessor ( ) . 

7//////////////////////////////////////////////////////////////////////// 

'//////// f ///// 1 J ////// 1 //// f //////////// 1 f ////// f ////// f ////// f f //////// / 

7 Function: createCommaDataFormatter 

7 Description: This function creates and returns a comma data 

7 formatter object. 

7 Preconditions: None. 

7 Postconditions: The pointer to the created comma data formatter 

7 object cannot be 0. 

7 Algorithm: 1. creates and returns an object of the class 

7 CCommaDataFonnatter. 

///////////////////////////////////////////////////////////////////////// 

7//////////////////////////////////////////////////////////////////////// 

7 Function: createXMLDataFormatter 

7 Description: This function creates and returns an XML data 

7 formatter object. 

7 Preconditions: None. 

7 Postconditions: The pointer to the created XML data formatter 

7 object cannot be 0. 

7 Algorithm: 1. creates and returns an object of the class 

7 CXMLData Formatter . 

7//////////////////////////////////////////////////////////////////////// 
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////////////////////////////////////////////////////////////////////////// 



// Function: 
// Description: 
// 

// Preconditions: 
// Postconditions: 
// 

// Algorithm: 

// 



createSmtpProtocolProcessor 

This function creates and returns an SMTP protocol 

processor object. 

None. 

The pointer to the created sratp protocol processor 
object cannot be 0. 

1. creates and returns an object of the class 
CSmtp Protocol Processor . 



////////////////////////////////////////////////////////////////////////// 



////////////////////////////////////////////////////////////////////////// 



// Function: 
// Description: 
// 

// Preconditions: 
// Postconditions: 
// 

// Algorithm: 

// 



createFtpProtocolProcessor 

This function creates and returns an FTP protocol 

processor object. 

None. 

The pointer to the created ftp protocol processor 
object cannot be 0. 

1. creates and returns an object of the class 
CFtpProtocolProcessor . 



////////////////////////////////////////////////////////////////////////// 



Figure 18D 



Page 67 of 78 



Target I 
Application I 

nt int 1 : selectFormatProtocol 

m 



CMonitor 









nt int 2: selactFormatPratocol 

m 



CMonitorManaaer 



Int int 3: storeFormattndProtocol 

m 



Format & Protocol 
Information Base : $y$^>n 



Figure 19 



Page 68 of 78 



610 




Format And Protocol Information Base Package Class Structure 



Figure 20 



Page 69 of 78 



56i 



; System Mgnapgr 



1: atoreFormatAndProtocol 



610- 




600 

/ 



rcmayrotacolVBctortdaia 



PrntftCftlFftrmayfirtorMaR 



CFormatProtbcol-lhtermstlonBafia i 



At;9tep-3j8nd 47Storev ^ 
th e format and protocol 

— | jri; triel map;of jnt ! list *ln!> 

of at^'whsre the first : ; : 
IsthakBy 



t lnt 



CForm^r^cotComblri^hChBCk; 



& 2: IsFormatProtocolComblnationOK 



Figure 21 



Page 70 of 78 



560 



1 : getF ormatAndProtocofVector 



int and vector, are 
returned as out 
parameters ; 




FormatProtQcoiVactorMap 



FomnatProtocofVectorMap, ProtocolFormatVectorMap 



getfoiTTiatProtocoIVectorMapAJterChecklngProtDcolRastrlction 



620 



The function passes the two maps to verify the restriction on 
pjotdcof. f FoirnatPitrtocojVec^^ Is In and: out ; The ; 
ForniatProtocpryedorMap is used for the return value. ^ ; 
ProtbcblFc^sWedoTMap=l8:{n. ; 



Figure 22 



Page 71 of 78 



CFontatProtocoi infcrmfrTton Base Class Specification 



Page I of 2 



Author: Tetsuro Motoyama 

5.2 CFonnatProtocoMnfonnationBase Class Specification 
5U.I Fosction List 



public: 

CFormalProtocol InformationBascQ; 

-CFormaiProtocot^InfonnatioiiBascO: 

void jtorcFormatA.DdProtocot(tnl in^nFormat, int in_nProtocoIX 

bool getFonnalAndProtocorVectDr<tnt Jk outn Format, lt«<hrt> &. out_ProtocolVector); 



void setDcfauhFormaiAndProtocolO; 
SX1 Class Attribute* 



Type 


Attribute Name 


Description 


nuur^iot, list<int> > 


m_PormatProtocolVectorMap 


The key is a formal value, and the list is the hst of 
protocol vahies associated to the key. Because 
subscripting Q is not needed in thij implementation, 
list is used for the vector implauculalion. This map is 
used to return the necessary information for 
getFormatAndProtocoIVector function 
Note: > > is > space > to distinguish from that 
is used by toatreom* 


mspcint, list<int>> 


ro_pTOtocolFormatVcctorMap 


The key is a protocol value, sod the list is the tist of 
format values associated to the key. Because 
subscripting Q is not needed in this implementation, 
list is used for the vector implementation. This map is 
used to modify the map above if the protocol can take 
only one fonn&L 


boot 


m_bPtntOctCaIl 


This flag is used to call the function in 
CFrotocolRestrictioitCheck. The constructor set this to 
be true. The function, getFcrmalArjdYratocolVector, 
sets it to be false 


marrdnt. Iist<trit> >: iterator 


m_FonnalProtocoi VectorMap I tcrstor 


Iterator used to iterate the map. 


CTorroatProtocolCombination Check 


m_FormaiProtocolC^cmbinatioQChcclc 


This object is to check the combination of format and 
protocol 


CProtccolRcstrictionChcck 


rn_ProtocoLRe3trictionCh£ck 


This object is to check the protocol restriction. 
Currently, the only restriction is if protocol can have 
only one format support 



Fu action Definitions 



///////////////////////////////////////////////////////////////// 
//Function: C7onoatProtocol_lnfonaationBa3e 
//Do script ion: Constructor ~ 

//Preconditions: None 
/ / Postconditions : Hone 

//Algorithm: Set m bFirstGetCall to true 

//////////////////////////7////////////////////////////////////// 



///////////////////////////////////////////////////////////////// 
/ /Function : -CFomatProtocol_InfiormationBa8e 
//Description: Destructor 
/ /Pr econdi t ions : None 
/ / Po a t condi tions : None 
//Algorithm: Default 

///////////////////////////////////////////////////////////////// 



h ttp l//www. $tr . ricoh . com/doc_cx«trol/proj_docs/j Mydoc/q6_dj04_08/fbfmat_prot- . 7formiilprotoc^_infomi«tioobaseclass-ht 0 1 /2 5/2000 
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///////////////////////////////////////////////////////////////// 



//Function: 
//Description: 
// 
// 

//Preconditions: 

//Postconditions: 

//Algorithm: 

// 
// 
// 
// 
// 
it 
// 



s to re Po rma tAnd Protocol 
Check the passed format and protocol values 
to be valid or not. If valid, store the 
values into the two maps 
Hone 
None 

1. Send two values to check the combination 
through IsFonaatProtocolComhi nationOK 
function. 

2. Check the return bool value. 

3. If yea, save format and protocol values 

into two maps (Figure 5.4 of the 
Specification, Q6-DJ04-08) 
Else, do nothing. 



///////////////////////////////////////////////////////////////// 



/////////////////////////////////////////////////////////////// 



Function: 
Description: 



Preconditions : 
Postconditions : 



Algorithm: 



get Forma tAndProtocol Vector 
The function returns a format and a list 
of protocol values associated with the 
format through two parameters. The function 
returns true if a format and list are 
returned, false otherwise. 
None 

The format value is within the range. 
The list is not empty and contains the values 
within the range. 
1. 



1.1 



1.2 



If mJbFixstGetCall (Figure 5.5 of the 
Specification Q6-DJ04-08) 
call the function to check the protocol 
restriction. 

check if m_Fo rma t Protocol VectorHap is 
empty. If empty, set it to default 
values of format and protocol by calling 
setDe fault Forma tAndProtocol function. 

1 . 3 set the iterator to begin ( ) . 

1.4 set m_bFirstGetCall to be false 
2. If iterator is end, return false. 

else (Figure 5.6 of the Specification 
Q6-DJ04-08) 
got format and list to return and set 
return parameters, 
increment iterator. 
Return true. 

//////////////////////////////////////////////////////////////// 



/////////////////////////////////////////////////////////////////// 
//Private Function: setDefaultFormatAndProtocol 



//Description: 
// 

//Preconditions : 
/ / Pos tcondi t i ons : 

// 

//Algorithm: 



The function sets the default values for 
format and protocol in the map. 
The m_Format Protocol VoctorNap is empty. 
The map contains one default format and a 
protocol list with one default protocol. 
Set the map with the default values . 



/////////////////////////////////////////////////////////////////// 



it 



top://www.«r.ri<^com/ilocj»n^ 01/2572000 
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5-3 CForraatProtocoICombinationCheck Class Specification 

5J.1 Function list 

public: 

CFonnatProtocoICombinationCheckO; 
^FonnaiProtocolCombiiiaijooChecfcO 

bool isFonnalProtocolCojnbtnatiooOK(eaist int injiFormat, cons bit m_nProtocol); 

private- 
void initMatrixO; 

5-3J Class Attributes 





Attribute Name 


1 Description 


majKint, set<im> > 


ni_CotnbinatioiiMstrix 


(Key is the fbnnat The set contains the protocols that are valid 
nor the particular formal 



3Jw3 Function Definitions 



///////////////////////////////////////////////////////////////// 



//Function: 
//Description: 
//Preconditions : 
//Postconditions : 
//Algorithm: 



CFormatProtocolCombinationCheck 
Constructor 
Nono 
None 

call initMatrix 



///////////////////////////////////////////////////////////////// 



///////////////////////////////////////////////////////////////// 
//Function: -CFormatProtocolCombinationCheck 
//Description: Destructor 
//Preconditions: None 
//Postconditions : None 
//Algorithm: Default 

///////////////////////////////////////////////////////////////// 



///////////////////////////////////////////////////////////////// 



//Function: 
//Description: 
// 
// 

//Preconditions : 
//Postconditions : 
//Algorithm: 
// 
// 
// 
// 
// 
// 
// 



is Format ProtocolCambinationOK 
Chock the passed format and protocol values 
to be valid or not. If valid, return yes, 
no othorwiso 
None 
None 

1. Ose find function of the Matrix for 
in_nFormat 

2. If returned iterator is end, return No 

3. get the set value for the key format 

4. Use tho find function of the set for 
in_nProtocol 

5. if returned iterator is end, return no 

6. return yes 



'0 i>{A 



///////////////////////////////////////////////////////////////// 
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//////////////////////////////////////////////////////////////////// 
//Private Function: initMatrix 
//Description: 
// 
// 

/ /Precondi t ion : 
//Postconidltion: 
//Algorithm: 
// 
// 
// 
// 
// 
// 
// 
// 



This function initializes m_CofnbinationMatrix. 

If new formats or protocols are added, this 

function must be modified. 

None 

None 

1. Create the local set<int> 
2 for each format 

2.1 fill in the local set 
with the protocol numbers 
that are valid for the format, 
using insert function 

2.2 m__CoabinatlonMatrix{ format] 

- local set 

2.3 clear local set 



//////////////////////////////////////////////////////////////////// 



1*9 
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5.4 CProtocolRestrictionCbeck Class Specification 
5.4.1 Fanctioi List 



public: 

CProtocoIRestrictionChedcO; 
-CProtocolRatrictionCheckO 

VOtd ggtFnrmatPmfnmfVwrtrtrMitpA fti»W^W*rj T »gP^t™^(p r ^ r ri CT 

(map<int, lia<int> > & inOut_Map, const map<ut, Ust<int> > A in_Map); 

private: 

void mitOneFormmRestrictkmO; 
void cmcFormatRestrictioa 

(msjKint, lisKint> > A inOut_Map, const map<tnt, list<m > > A in_Map); 



5.4 J Class Attributes 



Type 


Attribute Nuns 


Dctcriptiott 


vector<boot> 


m_bOncFonnatRestrictioQ 


Array size should be protocol The position corresponds 
to the protocol. 



5.4J Function Definitions 



///////////////////////////////////////////////////////////////// 
//Function: CProtocolRestrictionCheck 
//De script ion: Constructor 
//Preconditions: Hone 
/ /Postconditions : None 

//Algorithm: call initOneFormatRestriction 

///////////////////////////////////////////////////////////////// 



///////////////////////////////////////////////////////////////// 

//Function: -CProtocolRestrictionCheck 

//Description: Destructor 

//Preconditions : None 

//Postconditions : None 

//Algorithm: Default 

///////////////////////////////////////////////////////////////// 



/////////////////////////////////////////////////////////////////// 
//Function : getroxmat Protocol VectoxHapAf terCheckingProtocolRe strict ion 

//Description: Check the restriction on the protocol. 

// Currently, there is only one possible restriction 

// defined in the requirements. If there are more 

// restrictions, more private functions should be 

// added and called. 

/ /Preconditions : None 
//Postconditions: None 

//Algorithm; 1. Call onerormatRestriction function 

/////////////////////////////////////////////////////////////////// 



//////////////////////////////////////////////////////////////////// 
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//Private Function: in i t One Forma tRestr ict ion 



//Description: 

// 

// 

//Preconditions: 
/ / Poa tcondi t i ons : 
//Algorithm: 
// 
// 
// 
// 
// 
// 
// 
// 



This function initialize the attribute 
mJbOneFonnat Restrict ion. If more protocols ace 
added, this initialization must be modified. 
None 
None 

1. use assign (size+l, false) to initialise the 
vector to false. 

2. set the entries of true. 

Note: for class debug version, use 
ifdef and 

bool c posl - m_bOneFormatRestriction|l] ; 
bool 4 poa 2 - m_bOneForaatRestriction{2) ; 
and so on to be able to see and to 
change the value. 



/////////////////////////////•/////////////////////////////////////// 



Description: 



Preconditions: 
Postconditions 
Algorithm: 



////////////////////////////////////////////////////////////////// 
Private Function: oneFormatRestriction 

This function receives two maps and if the one 
restriction is true for given protocol, the 
content of inOut_Map lm_FonnatProtocolVectorttap> 
is adjusted accordingly? 
None 
None 

Iterate over the in_Kap (m_ProtocolFonnatVectorMapj 

1. get the key (pkey) 

2. If m_bOneFormatRestriction[pkey] 

2.1 get the value list of in_Map for the key 

2.2 local int laatForaat - backO, 

2.3 iterate over the list 
if * Iterator NX last Format 

iterate over inOut_Kapf*iterator) list 
if the value EQ pkey 

erase the entry from the list 

3. Iterate over inOut_Map 
if value list is~"empty, 

erase the entry from inOut_Map 



'Example: 

m bOneFormatRestriction 



0 12 3 4 

[0,0,1,0,1] 
0: false, 

inOut Map (m Format ProtocolVectorMap) 

- T lr <l72,3,4> --> <1, 

2, <2,1,3,4> — > <1, 

3, <3,4,1,2> --> <3, 

4, <2,4>> --> <> 
in_Map (m_Protocol Forma tVectorMap) 

- (1, <1, 3, 2> 

2, <4, 3, 2, 1> 

3, <1, 3, 2> 

4, <4, 2, 1. 3>l 

pkey - 1 m_bOneFormatRestriction[l) - 0 
pkey - 2 m_bOneFormatRestriction[2] - 1 
value list - <4, 3, 2, 1> (2.1) 



(four protocols) 
1: true 



2, 3> 
3> 

4, 1> 



last Format 

4 !- 1 

inOut_Map [ 4 ] 
erase value 2 

3 !- 1 

lnOut_Map(3) 
erase value 2 

2 !-l 

inOut_Hap[2] 
erase value 2 

1 — 1 



(2.2) 



<2,4> 
<4> 



- <3,4,1,2> 
<3.4,1> 



- <2, 1,3,4> 
<1, 3,4> 



IS* 



pkey - 3 m_bOneFormatRestriction[31 
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// pkey - 4 m_bOneFormatRestriction[4) - 1 

// value list - <4, 2. 1, 3> 

// last Format - 3 

// 4 !- 3 

// inOut_Map(4) - <4> 

// erase value 4 <> 

// 2 !- 3 

// inOut_Map[2] - <1,3,4> 

// erase value 4 <1,3> 

// 1 !- 3 

// inOut_Hap{l) - <1,2,3,4> 

// erase value 4 <1,2,3> 

// 3 — 3 

// Iterate over lnOut_Hap 

// if * inOut_Ma p_iterat or. empty () then erase 

// inOut_Map 

// ■ ( 1, <1, 2, 3> 

// 2, <1, 3> 

// 3, <3, 4, 1>) 
// 



//////////////////////////////////////////////////////////////// 



fy 4 



Z<5<L 
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